home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / zcdoc987.arc / zcommdoc.ae < prev    next >
Text File  |  1987-09-27  |  76KB  |  1,801 lines
  1.  
  2.         Revised 09-05-87                        Universal Line Printer Edition
  3.         ZCOMM User Manual                                                  121
  4.  
  5.  
  6.         20.  TERM FUNCTION
  7.  
  8.         Interactive conversation with the remote is controlled by the term
  9.         function.  The term function provides the conversational link between
  10.         the keyboard, display, printer, and the remote computer.  ZCOMM's term
  11.         function also controls the capture of data from the remote, "non-
  12.         protocol" sending of files and commands, and recognition of the
  13.         remote's responses (pattern searches).
  14.  
  15.         The term function is entered by the F2, f, put, putw, t and wait
  16.         commands, and by the r and s commands when the t option is used.
  17.  
  18.         Normally, the term function acts upon keyboarded characters
  19.         immediately.  If the term function is sending a string with the put or
  20.         putw commands, or if the keyboard has been locked with the kbdlock
  21.         command, keystrokes are not drained from the keyboard buffer.  If ANSI
  22.         KAM (Keyboard Action Mode) is set, keystrokes are discarded with a
  23.         bleep of the bell.
  24.  
  25.         Normal ASCII printing and control characters are sent to the remote.
  26.         Some keys may be redefined with the set command.  NUKE (ALT-N) returns
  27.         control to the main command prompt.  The term function returns to its
  28.         caller when an F1 or ALT-X key is struck.
  29.  
  30.         A carrier drop during a pattern search or a satisfied search[1] cause
  31.         the term function to return.  Counting the error count (e numeric
  32.         parameter) UP TO 0 makes term function return.  An ETX or EOT received
  33.         from the remote when q mode is on also does the trick.  Finally, an
  34.         EOF on a file uploaded with x mode, or a match on a file uploaded with
  35.         X mode makes the term function return.
  36.  
  37.         20.1  Command Characters
  38.  
  39.         In the term function, soft key definitions override the keys' normal
  40.         functions.
  41.  
  42.         Backspace Normally the term function sends backspace to the remote
  43.           without any special processing.  This is ideal for most systems
  44.           where backspace implies deletion of the character immediately to the
  45.           left of the cursor.  Other systems, including VMS, use RUBOUT for
  46.           this function.  The GCOS system uses the # character for this
  47.           function.  The special requirements of these systems can be
  48.           optimally accomodated by assigning a string or series of commands to
  49.           the BS key.  Chapter 99 provides some examples.
  50.  
  51.  
  52.  
  53.         __________
  54.  
  55.          1. Unless the c modifier was used
  56.  
  57.  
  58.  
  59.         (C) 1987 Omen Tech Inc                        Chapter 20 Term Function
  60.  
  61.  
  62.         Revised 09-05-87                        Universal Line Printer Edition
  63.         ZCOMM User Manual                                                  122
  64.  
  65.  
  66.         F1, ALT-X Return from the term function.  ALT-X is an alternate to F1
  67.           in case the user has assigned his own string or command to F1.
  68.  
  69.         F2, PgUp, PgDn, ALT-R Enter the review function displaying data
  70.           starting with either the first character received after the last
  71.           character keyboarded (except space, Ctrl-Q, or Ctrl-S), or about 48
  72.           lines back if less than 400 characters have been received since the
  73.           last character keyboarded.  This allows the output from the last
  74.           command to be conveniently reviewed.  Review then awaits the next
  75.           command.
  76.  
  77.           F2 followed by "k" is a handy way to clear both the screen and the
  78.           circular buffer.
  79.  
  80.         Home Enter review function, displaying text starting at the beginning
  81.           of the buffer.  ALT-R is an alternate to F2 in case the user has
  82.           assigned his own string or command to F2.
  83.  
  84.         F3...F14 Chapter 17 describes the functions that the "setup" entry in
  85.           the sample PHODIR.T file assigns to these keys.
  86.  
  87.         Ctrl-Break Sends a 200 millisecond (default) break signal to the
  88.           remote.  The function of this key may be reassigned with a set
  89.           command.
  90.  
  91.         Ctrl-Shift-2 Some remote computer systems may require sending the NULL
  92.           (000) character.  NULL may be keyboarded by Ctrl-Shift-2.
  93.  
  94.         ^F Iff q (TWX) mode is in effect, transmit the string parameter
  95.           answerback to the remote.  This is equivalent to HEREIS on a
  96.           Teletype(TM) machine.
  97.  
  98.         Enter Iff n mode is set, send a newline (LF).  Otherwise, send the
  99.           contents of entstr (default CR) to the remote.
  100.  
  101.         ^Q Iff a transmit file is open and its transmission has been stopped
  102.           by a XOFF, transmission is resumed.  Resumes counting of the
  103.           inactivity timeout associated with the wait and pattern commands.
  104.           Otherwise no special treatment.
  105.  
  106.         Rubout The ASCII delete (rubout) character (hex 7F, octal 177) is
  107.           generated by Ctrl-Backspace (the left arrow above the ENTER key on
  108.           the PC keyboard).  The "Del" key near the lower right of the
  109.           keyboard does not generate delete, but may be programmed to do so
  110.           with a "set fdel \177" command.
  111.  
  112.         ^S Iff a transmit file is open, transmission is stopped.  Otherwise ^S
  113.           is transmitted.  ^S also suspends counting of the inactivity timeout
  114.           associated with the wait and pattern commands.
  115.  
  116.  
  117.  
  118.  
  119.         (C) 1987 Omen Tech Inc                        Chapter 20 Term Function
  120.  
  121.  
  122.         Revised 09-05-87                        Universal Line Printer Edition
  123.         ZCOMM User Manual                                                  123
  124.  
  125.  
  126.         ALT-B Sends a 100 millisecond break signal to the remote.
  127.  
  128.         ALT-N The NUKE key exits from the term function with a message and
  129.           cancels any scripts or functions that may have been executing.
  130.  
  131.         ALT-1 Prompts for a DOS command, then executes that command as a
  132.           subroutine.
  133.  
  134.           EXAMPLE: ALT-1 whereis *.lst
  135.  
  136.  
  137.         ALT-2 Prompts for a ZCOMM command, then executes that command.  A
  138.           particularly useful command is "create file" which creates a capture
  139.           file without having to return to the main command prompt.  Care
  140.           should be exercised not to force excessive recursion by issuing a
  141.           command (such as t or f) which would invoke the term function
  142.           recursively.
  143.  
  144.           EXAMPLE: ALT-2 create capture.fil
  145.  
  146.  
  147.           EXAMPLE: ALT-2 display vt100
  148.  
  149.  
  150.         ALT-E Resets the elapsed time indication to zero.
  151.  
  152.         ALT-F Full Duplex resets local echo of keyboarded characters.
  153.  
  154.         ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local
  155.           echo), and 2 (local echo CR as CR LF).  SEE ALSO: h numeric
  156.           parameter
  157.  
  158.         ALT-I Three way toggle of i and I (Image) mode.  When toggling to I
  159.           (super image) mode, ZCOMM's display emulation is set to dumb to
  160.           disable all escape sequences, most importantly those that do strange
  161.           things when used in the wrong context.  When toggling out of I mode,
  162.           dumb terminal emulation is turned off.
  163.  
  164.         ALT-J Toggles j (Jabberwrite) mode (q.v.).*
  165.  
  166.         ALT-K Displays the contents of the soft keys.
  167.  
  168.         ALT-L Ctrl-PrtSc Toggles the line printer on flag.  If the printer is
  169.           being turned on, printing commences with the next character received
  170.           from the remote.
  171.  
  172.         ALT-M Toggles keyboard mapping.
  173.  
  174.           SEE ALSO: display kbmapenable command
  175.  
  176.  
  177.  
  178.  
  179.         (C) 1987 Omen Tech Inc                        Chapter 20 Term Function
  180.  
  181.  
  182.         Revised 09-05-87                        Universal Line Printer Edition
  183.         ZCOMM User Manual                                                  124
  184.  
  185.  
  186.         ALT-O Toggles the Overstrike display mode, and restores the normal CRT
  187.           attribute.
  188.  
  189.         ALT-P Toggles the parity the term function uses between 8 bits no
  190.           parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd
  191.           parity, 7 bits marking parity (8th bit set), and 7 bits spacing
  192.           parity (8 bit reset).
  193.  
  194.         ALT-V Three way toggles v mode between normal, show control characters
  195.           as ^C, and, (in addition to the above) denote characters with parity
  196.           bit set by prepending a tilde (~).
  197.  
  198.         20.2  Control Characters
  199.  
  200.         The following characters are recognized by the term function when they
  201.         are received from the remote.
  202.  
  203.         ENQ, DLE If c or C (Compuserve) mode and not v mode is in effect,
  204.           engage the Compuserve B Protocol.  This protocol is used with the
  205.           FILTRN program and the SIG/ACCESS DOW and UPL commands.  See
  206.           Compuserve's CP-MIG user group documentation for more information.
  207.           Iff enabled, these codes are acted upon when drained from the
  208.           interrupt input buffer and are not passed to the circular buffer.
  209.  
  210.         The following received characters are recognized by the term function,
  211.         regardless of parity, when they are fetched from the circular buffer
  212.         for the display.
  213.  
  214.         Modem Error Detected modem errors (parity error, framing error, break,
  215.           overrun) are counted in the e numeric parameter.  The E numeric
  216.           parameter may be used to represent modem errors as specific,
  217.           searchable characters.
  218.  
  219.           A detected overrun is displayed as a large fuzzy rectangle (hex B2).
  220.  
  221.         ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host
  222.           Operation) these control characters will terminate the message.
  223.  
  224.         ENQ Iff q (TWX) mode or VT100 emulation ("display vt") is in effect,
  225.           transmit the answerback string parameter to the remote.  This is
  226.           equivalent to HEREIS on a Teletype(TM) machine.
  227.  
  228.         BELL Generates a tone in the speaker unless visual bell display is
  229.           enabled ("display bell=visual").  If the display has fallen behind
  230.           the incoming data, ZCOMM suppresses the bell due to the relatively
  231.           long time required to perform a bell ring.  If a file is being
  232.           transmitted with the term function, a bell character will pause
  233.           transmission for a short time.  (Some computers send bell characters
  234.           to indicate their input buffers are becoming overloaded.)
  235.  
  236.  
  237.  
  238.  
  239.         (C) 1987 Omen Tech Inc                        Chapter 20 Term Function
  240.  
  241.  
  242.         Revised 09-05-87                        Universal Line Printer Edition
  243.         ZCOMM User Manual                                                  125
  244.  
  245.  
  246.         FF If c mode is enabled, erase the screen.
  247.  
  248.         XOFF Suspends file transmission from ZCOMM.  XOFF is excluded from
  249.           pattern searches and does not display unless v mode is set.  After a
  250.           timeout determined by the Kermit s numeric parameter (default 60
  251.           seconds), transmission will resume even if no XON character is
  252.           received.[2]
  253.  
  254.         XON Resumes file transmission from ZCOMM.  XON is excluded from
  255.           pattern searches and does not display unless v mode is set.
  256.  
  257.         NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
  258.           in i (image) or v mode.  They are excluded from pattern searches.
  259.  
  260.         20.3  Buffer Writing
  261.  
  262.         When the free space in the circular buffer is nearly exhausted, ZCOMM
  263.         sends an XOFF character to the remote[3] and writes the buffer
  264.         contents to the receive file[4] (if any).  The circular buffer is also
  265.         written to the receive file as a result of a "w" command, ALT-W key,
  266.         or once per second if the j mode is in effect.
  267.  
  268.         When the circular buffer is written to a receive file, several control
  269.         characters are treated specially if i (image) mode is not set.  Iff s
  270.         mode is set, all control characters, except for those listed below,
  271.         are excluded from the received file.
  272.  
  273.         NULL ACK BELL XON XOFF RUBOUT These characters are excluded from the
  274.           file.  NULL, DELETE, XON, and XOFF are excluded from pattern
  275.           searches.
  276.  
  277.         ETX, EOT These characters close the file if q mode is in effect, as
  278.           when ZCOMM is receiving a message in host state using TWX protocol.
  279.  
  280.         Ctrl-Z (CPMEOF) Iff z mode is enabled, close the file.  Otherwise this
  281.           character is discarded.
  282.  
  283.         LF Iff n (nlmode) mode is on, a CR is written to the file before the
  284.           LF.  Linefeed is always passed to the file.
  285.  
  286.  
  287.  
  288.         __________
  289.  
  290.          2. There is no timeout if the parameter is 0.
  291.  
  292.          3. Assuming e mode is not in effect.
  293.  
  294.          4. An XON is sent to the remote after this automatic buffer write
  295.             operation.
  296.  
  297.  
  298.  
  299.         (C) 1987 Omen Tech Inc                        Chapter 20 Term Function
  300.  
  301.  
  302.         Revised 09-05-87                        Universal Line Printer Edition
  303.         ZCOMM User Manual                                                  126
  304.  
  305.  
  306.         CR Iff a mode is in effect, a CR LF sequence is written to the file.
  307.           Otherwise, if s mode is on, CR is only written to the file as a
  308.           response to an LF in the circular buffer.
  309.  
  310.         BS Backspace is written to the file unless s mode is in effect, in
  311.           which case it, and the last character written in the disk file, are
  312.           deleted by backspacing the file write pointer.  This simulates the
  313.           function of backspace on common CRT terminals.
  314.           NOTE: This backspacing of the file write pointer operates the same
  315.           as Teco and Emacs editors; it does not stop at the beginning of the
  316.           line.  Backspacing over tab characters is tricky because it may take
  317.           several backspaces to eliminate the spaces corresponding to one tab
  318.           character, but only one is needed to eliminate the tab character in
  319.           the output file.
  320.  
  321.         HT FF These characters are always passed to the file, even if s mode
  322.           is in effect.  If ss mode is in effect, FF is not passed to the
  323.           file.
  324.  
  325.         20.4  Real Time Status Line
  326.  
  327.         A real time status line is displayed when ZCOMM is in the term
  328.         function.  The left part of this status line is also displayed when
  329.         ZCOMM is in Host Operation awaiting a call.
  330.  
  331.         The first character position shows a blinking W if the circular buffer
  332.         is being written to disk.  Otherwise, the first character position
  333.         shows an L if the keyboard has been locked by a kbdlock command, or C
  334.         if the Caps Lock key is activated.
  335.  
  336.         The second position shows an X if hardware handshaking is enabled and
  337.         Clear to Send (CTS) is not received from the modem, or if an XOFF
  338.         character has been received (software handshake).  This also happens
  339.         when a file upload is using the p mode with GOchar = 17 (17 is decimal
  340.         for XON) and ZCOMM has stopped at the end of a line.  Otherwise, an A
  341.         is shown to indicate Alternate Keypad operation.  Otherwise, an N
  342.         appears if the Num Lock key is activated.
  343.         SEE ALSO: handshake command, Terminal Emulation, Chapter 99.
  344.  
  345.         The third position displays the real time status of the following five
  346.         conditions.  If more than one of the conditions is active at once, the
  347.         displayed character will represent the condition listed first.
  348.  
  349.         X   if the buffer has nearly filled up and ZCOMM has sent an XOFF to
  350.             suspend data transmission from the remote.
  351.  
  352.         E   when ZCOMM has sent an XOFF to suspend data transmission for Error
  353.             Containment(TM).
  354.  
  355.         S   if the term function is searching for one or more strings (defined
  356.             by the pattern command).
  357.  
  358.  
  359.         (C) 1987 Omen Tech Inc            Chapter 20 Term Function Status Line
  360.  
  361.  
  362.         Revised 09-05-87                        Universal Line Printer Edition
  363.         ZCOMM User Manual                                                  127
  364.  
  365.  
  366.         W   if term is waiting for a character echo before resuming
  367.             transmission.
  368.  
  369.         w   if term is waiting for a fixed time before sending the next
  370.             character or returning from a putw or wait command.
  371.  
  372.         The display column and row numbers are displayed next with the home
  373.         position equivalent to 1, 1.  DOS's idea of the time of day is next.
  374.         The minutes of elapsed time follow the time of day, modulo 24 hours
  375.         (1440 minutes).  The elapsed time is reset by the ALT-E term
  376.         subcommand and by the autodial.
  377.  
  378.         If carrier detect is absent, an L( Local) appears after the elapsed
  379.         time.  The X.PC version will display c, p, or L in this position
  380.         depending on whether ZCOMM is in character state, packet state, or
  381.         Local (no carrier).
  382.  
  383.         The right side of the status line shows the communications port,[5]
  384.         transmission speed ("baud rate") and the parity.
  385.  
  386.         The next field represents the modes that are enabled.  If the b, n, p,
  387.         r, or w mode is set, that letter shows.  If p mode is set with with
  388.         GOchar equal to XON (decimal 17), a P is shown.
  389.  
  390.         The v mode causes the view indicator to show ^ if control characters
  391.         are being displayed in the style ^C where C is the alphabetic
  392.         character corresponding to the control character.  The indicator shows
  393.         ~ if characters with the 8th bit set are being displayed with a
  394.         leading ~.
  395.  
  396.         Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z modes causes the
  397.         corresponding letter to be displayed.  The c, h, and s modes are
  398.         displayed in upper case if their value is greater than 1.
  399.  
  400.         ON HOOK is displayed if the computer has disabled DTR (Data Terminal
  401.         Ready).  The speed command should be used to assert DTR and allow the
  402.         modem to go off hook (connect to line), e.g., "speed 1200".
  403.  
  404.         If a transmit file is open, a < followed by the transmit file name is
  405.         shown.
  406.  
  407.         If the file upload has been stopped by a grab command, Stopped(grab)
  408.         is diplayed.
  409.  
  410.         If a receive capture file is open, a > followed by the file name is
  411.  
  412.  
  413.         __________
  414.  
  415.          5. Virtual channel number for X.PC
  416.  
  417.  
  418.  
  419.         (C) 1987 Omen Tech Inc            Chapter 20 Term Function Status Line
  420.  
  421.  
  422.         Revised 09-05-87                        Universal Line Printer Edition
  423.         ZCOMM User Manual                                                  128
  424.  
  425.  
  426.         shown.
  427.  
  428.         EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424    1:1200 8n p^t <upload.fil
  429.         The keyboard has been "locked" by a kbdlock 1 command.  File upload
  430.         has been stopped by an XOFF character.  The cursor in in column 1,
  431.         line 24.  The elapsed time is 46 seconds.  Carrier is not present (L).
  432.         There are 31424 free bytes in the circular buffer.  Transmission speed
  433.         is 1200 bits per second.  Transmitted word length is 8 bits no parity
  434.         (8n).  Since a speed of 1200 selects 1 stop bit, the mode is the same
  435.         as "8-N-1" mentioned by many bulletin board systems.  The p mode makes
  436.         file upload pause at the end of each line for a prompt character.
  437.         View mode is set (ena -v).  Finally, t mode slows the transmission of
  438.         each character from a soft keys or file.  The disk file upload.fil is
  439.         being uploaded.
  440.  
  441.         The s numeric parameter sets the status line display attribute.  The
  442.         default of 7 provides normal video.  With some displays, you can set
  443.         it to dim with a ps8 command so it won't distract you.  It may be
  444.         disabled with an "ESC x 1" sequence.
  445.  
  446.         20.5  Conference Command
  447.  
  448.  
  449.         Some computer networks provide a keyboard to keyboard multiuser
  450.         conference where text lines keyboarded by each user are broadcast to
  451.         the other participants.
  452.  
  453.         An example is the "Conference" command of Compuserve's Special
  454.         Interest Groups.  The following discussion will reference this edited
  455.         transcript of a CB conference.  At the beginning, we have logged into
  456.         Compuserve and have issued ZCOMM's conference command.  The user's
  457.         input is composed in a conference window using the 25th line.  The
  458.         line of text is transmitted (shown underlined) when ENTER is
  459.         keyboarded.
  460.  
  461.         go cb1
  462.         CB Simulator Ver 3(61) Band A
  463.         What's your handle?  chuckF<ENTER>
  464.  
  465.         (Channel) users tuned in
  466.         (1)8
  467.         Which channel: 1<ENTER>
  468.         (A1,Fleming) ho ho
  469.         (A1,*WOLF*) HI ALLL!!!!!!
  470.         greetings<ENTER>
  471.         (A1,MOON KNIGHT) HI ALL !!
  472.         (A1,*WOLF*) HELLO
  473.         (A1,scott) i'll dream about you
  474.         (A1,Fleming) back
  475.         (A1,*WOLF*) HI FLEM
  476.         (A1,Fairlady) xxx my young Scott
  477.  
  478.  
  479.         (C) 1987 Omen Tech Inc                   Chapter 20 Conference Command
  480.  
  481.  
  482.         Revised 09-05-87                        Universal Line Printer Edition
  483.         ZCOMM User Manual                                                  129
  484.  
  485.  
  486.         (A1,Golden Bear) Hi Fairlady !!
  487.         (A1,MOON KNIGHT) SCOTT-ARE YOU AN ISLANDE FAN ?
  488.         (A1,*WOLF*) *usting*
  489.         (A1,MOON KNIGHT) (ISLANDER)
  490.         /exit<ENTER>
  491.  
  492.         A real-time multiuser keyboard to keyboard conference resembles
  493.         nothing so much as a lively conversation.  The computers' buffering
  494.         simulates humans' ability to talk and listen at the same time.  You
  495.         may experience a learning curve as visual cues replace the familiar
  496.         audible cues needed to decipher a complex conversation.
  497.  
  498.         The keyboarded inputs of the several users must be kept separate for
  499.         any sense to be made of the conversation.  The remote computer
  500.         provides the necessary buffering for the other participants, and ZCOMM
  501.         buffers your keying in a one line window.   When the conference
  502.         command is given, two cursors will appear.  The usual cursor will
  503.         follow the others' text as it arrives from the remote computer.  A
  504.         second cursor in the conference window follows the text that you
  505.         enter.
  506.  
  507.         While entering text to the conference window, the backspace key may be
  508.         used to erase keyboarding mistakes.  ^U may be used to erase all text
  509.         entered on the conference window.
  510.  
  511.         Beginning at column 64, the characters you enter will show in reverse
  512.         video to remind you that the line is getting long.  (Conferencing
  513.         software prepends your identifier or "handle" to each line you send; a
  514.         long line will drop characters or otherwise mess up others' displays.)
  515.  
  516.         When you keyboard ENTER, LF, or ESC, or when you fill up the
  517.         conference window, ZCOMM queues the line for transmission.  The
  518.         conference window cursor disappears while the line is queued for
  519.         transmission.
  520.  
  521.         The line is transmitted as soon as the previous line (if any) has been
  522.         sent.  When transmission begins, the conference window is cleared and
  523.         the conference cursor reappears, allowing the next line to be
  524.         keyboarded.  Any attempts to enter characters into the conference
  525.         window before transmission begins will ring the bell and be discarded.
  526.  
  527.         When in the conference command, the function keys operate the same way
  528.         as they normally do in the term function.
  529.  
  530.         The review subcommands (F2, PgUp, etc.) may be used to review portions
  531.         of the conversation that have scrolled off the main screen.  Returning
  532.         from the review subcommand redisplays any partial line that may have
  533.         been entered.
  534.  
  535.         The exit command F1 causes any characters entered in the conference
  536.         window to be discarded.
  537.  
  538.  
  539.         (C) 1987 Omen Tech Inc                   Chapter 20 Conference Command
  540.  
  541.  
  542.         Revised 09-05-87                        Universal Line Printer Edition
  543.         ZCOMM User Manual                                                  130
  544.  
  545.  
  546.         The following characters are passed directly to the remote and are not
  547.         entered into the conference window: ETX SI DLE XON XOFF DC2 DC4 CAN
  548.         (^C ^O ^P ^Q ^S ^R ^T ^X).
  549.  
  550.         Transmission from the conference window is controlled by the t, p, and
  551.         w modes and their associated parameters.  If none of these modes are
  552.         set, the line is transmitted at full speed.
  553.  
  554.         If Half Duplex mode h is set, ZCOMM echoes the line as it is
  555.         transmitted.  If h is 2, a linefeed is transmitted and displayed after
  556.         the carriage return.
  557.  
  558.         Compuserve conference access is most economical at 300 bps, plenty
  559.         fast for the participants' typing.
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.         (C) 1987 Omen Tech Inc                      Chapter 20 Review Function
  600.  
  601.  
  602.         Revised 09-05-87                        Universal Line Printer Edition
  603.         ZCOMM User Manual                                                  131
  604.  
  605.  
  606.         21.  REVIEW FUNCTION
  607.  
  608.         Review function commands page, search, cut, paste, and otherwise
  609.         manipulate captured data stored in the circular buffer.
  610.  
  611.         The review function displays the approximate location of the displayed
  612.         text within the circular buffer as a percentage of the buffer contents
  613.         on the status line.  Unless i mode is in effect, escape characters are
  614.         printed as $ (dollar sign) so escape sequences will not interfere with
  615.         scrolling.
  616.  
  617.         Review subcommands consist of a single character preceded by an
  618.         optional numeric argument.  (The default value is 1.) The numeric
  619.         digits and the command are not echoed as they are entered.  For
  620.         example, keyboarding 69+ moves down 69 lines.
  621.  
  622.         You don't have to wait for the screen to fill before entering the next
  623.         review subcommand.  This comes in handy with the n subcommand.  Since
  624.         the N subcommand searches in the reverse direction, you can thumb
  625.         through messages (by searching for the subject header) very quickly,
  626.         knowing that you can back up if you went past something interesting.
  627.  
  628.         The review function displays data on the local screen only, even in
  629.         host operation.
  630.  
  631.         The demonstration disk circular buffer search/cut/paste menu choice
  632.         demonstrates many of the review subcommands.
  633.  
  634.         21.1  Review Subcommands
  635.  
  636.         Defined soft keys are executed from review iff they do not conflict
  637.         with the permanent definitions.
  638.  
  639.         Ctrl-L, Ctrl-Home Ctrl-L (form feed) clears the screen and refreshes
  640.              the display without moving it.  Ctrl-L is useful after an error
  641.              printout within review, or after a subcommand that writes to the
  642.              screen such as ALT-D or ALT-S.
  643.  
  644.         a    Toggles the autowarp display mode, then refreshes the display.
  645.              If the autowrap display mode is enabled, long lines can be
  646.              viewed, but will cause lines at the top of the screen to scroll
  647.              off.
  648.  
  649.         G    Go to the Nth line and display from there.  If N is omitted, go
  650.              to the end instead.
  651.  
  652.         Home Display starting at the beginning of the capture buffer.
  653.  
  654.         r, R If a file is open as a result of a read command, read some more
  655.              of the file into the buffer, replacing about 3/4 of the previous
  656.              buffer contents (all if R subcommand).  A successful r subcommand
  657.  
  658.  
  659.         (C) 1987 Omen Tech Inc                      Chapter 21 Review Function
  660.  
  661.  
  662.         Revised 09-05-87                        Universal Line Printer Edition
  663.         ZCOMM User Manual                                                  132
  664.  
  665.  
  666.              erases the pointers set by the t and b subcommands.  The data
  667.              read in from the file may overwrite the data currently displayed
  668.              on the screen.  In this case, ZCOMM displays data starting with
  669.              the oldest.
  670.  
  671.         F2, PgUp, ^B, * Display the Nth previous page (one line overlap is
  672.              provided).
  673.  
  674.         SP, PgDn, ^F Clear screen and display the next Nth page.
  675.  
  676.         s, / Accept a search string, terminated by RETURN.  This string may
  677.              have character escapes.  Search through the buffer for the Nth
  678.              instance of string.  Lower case characters in string match either
  679.              case; upper case characters in string match upper case characters
  680.              only.  The display starts with that line.  If the search is
  681.              unsuccessful, ring bell.  The search begins at the top of the
  682.              display.
  683.  
  684.              SEE ALSO: ?, n, N subcommands
  685.              HINT: When searching through a large amount of text, the search
  686.              operation is fastest if the first character of the search string
  687.              does not occur often in the text.  For example, a 32kb buffer
  688.              consisting of numbers separated by many spaces can be searched in
  689.              a few seconds if the first character in the search string is a
  690.              digit, but may take more than twenty seconds if the search string
  691.              starts with spaces.  This sluggish behavior results from the
  692.              complexities in the search operation posed by the circular
  693.              buffer.
  694.  
  695.         ?    Prompts for search string as above, then searches backwards for
  696.              the Nth occurrence of string starting with the line above the top
  697.              of the buffer.
  698.  
  699.         n    Next searches for Nth occurrence of the previously entered string
  700.              in the direction of the last "/" or "?" subcommand.  Typical
  701.              usage would be to search for the first occurrence with the "/"
  702.              subcommand, then use "n" to find more matches.
  703.  
  704.         N    Next searches for next Nth occurrence of the previously entered
  705.              search string in the opposite direction to the original "/" or
  706.              "?" subcommand.
  707.  
  708.         UpCursor, - Backup N lines and redisplay.
  709.  
  710.         DownCursor, +, LF Move the display down N lines and redisplay.
  711.  
  712.         End  Go to the buffer end (where the most recent data is) and display.
  713.  
  714.         x    eXit returns to the previous function, and makes the term
  715.              function redisplay the last page of buffer contents.[1] This
  716.  
  717.  
  718.  
  719.         (C) 1987 Omen Tech Inc                      Chapter 21 Review Function
  720.  
  721.  
  722.         Revised 09-05-87                        Universal Line Printer Edition
  723.         ZCOMM User Manual                                                  133
  724.  
  725.  
  726.              restores the screen and keyboard to the same state they were in
  727.              before review was entered.  The x subcommand allows you to see
  728.              where you were if you were in the midst of keyboarding a command
  729.              to the remote when you entered review.
  730.  
  731.              EXAMPLE: Suppose you are typing in a line of commands and you
  732.              need to "thumb back" through the remote's output for some vital
  733.              nugget of information.  (After you enter a 20 line email reply
  734.              message, NOW Compuserve asks you for a certain random 8 digit
  735.              account number to mail it to!) No sweat, just hit some PgUp's
  736.              until you see the account number on the screen.  Now you can't
  737.              remember whether or not you typed a space after the last part of
  738.              you command to the remote.  No problem, just exit review with x
  739.              and you'll see just where you were.
  740.              NOTE: This subcommand should not be used when scripts are active.
  741.  
  742.         k    Kill the capture buffer contents and return to the previous
  743.              function.
  744.  
  745.         Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
  746.              insertion pointer to just after the end of the current display.
  747.              ZCOMM then redisplays the last lines of the buffer and returns to
  748.              the previous function.
  749.  
  750.         t    Set the file dump[2] and printer dump pointers to the top of
  751.              displayed text, and sets the bottom pointer to the end of the
  752.              buffer.  The t subcommand is used with the b subcommand to
  753.              specify which portion of the circular buffer should be written to
  754.              a file with the w subcommand.  (Text between the top and bottom
  755.              pointers is highlighted.)
  756.  
  757.         b    Set the bottom pointer to the beginning of the first line of
  758.              displayed text.  If the top pointer had not been previously set,
  759.              or if the bottom pointer is before the top pointer, ZCOMM will
  760.              ring the bell and ignore the subcommand.  Otherwise, the text on
  761.              the screen that was highlighted will now be displayed in normal
  762.              intensity as what is showing on the screen has just been
  763.              deselected.  (Text between the top and bottom pointers is
  764.              highlighted.)
  765.  
  766.  
  767.  
  768.         ______________________________________________________________________
  769.  
  770.          1. When the term function takes control, which is immediately if
  771.             review was called from the term function.
  772.  
  773.          2. This command should not be used while outputting to the printer (l
  774.             mode) or while a Receive File is open unless you wish to select
  775.             the data to be output.
  776.  
  777.  
  778.  
  779.         (C) 1987 Omen Tech Inc                      Chapter 21 Review Function
  780.  
  781.  
  782.         Revised 09-05-87                        Universal Line Printer Edition
  783.         ZCOMM User Manual                                                  134
  784.  
  785.  
  786.         w, W Write the text between the top and bottom pointers to a disk file
  787.              or DOS device.[3] If the bottom pointer is not set, the rest of
  788.              the buffer will be written.  ZCOMM prompts for a pathname.  If
  789.              the top pointer is not set, a reminder is printed.  No log entry
  790.              is made by this subcommand.  The W subcommand automatically
  791.              appends the data to an existing file.
  792.  
  793.         F1, CR Return to previous function.
  794.  
  795.         !    Prompts for a DOS command, then attempts to execute it.
  796.  
  797.         @    Prompts for a ZCOMM command, then executes it.
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.         __________
  834.  
  835.          3. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
  836.  
  837.  
  838.  
  839.         (C) 1987 Omen Tech Inc                   Chapter 21 Numeric Parameters
  840.  
  841.  
  842.         Revised 09-05-87                        Universal Line Printer Edition
  843.         ZCOMM User Manual                                                  135
  844.  
  845.  
  846.         22.  NUMERIC PARAMETERS
  847.  
  848.         Numeric parameters are set with the p command in the form px# where x
  849.         is the one letter name of the parameter and "#" is the decimal numeric
  850.         value.  Typing "p" without a parameter name displays the current
  851.         values of the numeric parameters in decimal.
  852.  
  853.         EXAMPLE: pg63 sets GOchar to decimal 63 (ASCII question mark).
  854.  
  855.  
  856.         EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
  857.         routine messages
  858.  
  859.  
  860.         #  The # numeric parameter sets the number of lines used by the built
  861.            in display driver.  The default value is 24.  A value of 25 may be
  862.            used for applications which require access to all 25 display lines.
  863.            A small value may be used when running ZCOMM under Topview to to
  864.            fit the information into a small window.  The cls or reset command
  865.            should be given after setting the parameters to initialize the
  866.            screen driver to the new values.  If running with a virtual screen
  867.            with Topview or DESQview, the #and $ numeric parameters are limited
  868.            to 24 by 80 maximum.  Full screen applications may give abnormal
  869.            displays if these parameters are set too small.  Nonsensical values
  870.            tend to produce nonsensical displays.
  871.  
  872.            EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
  873.            and initializes the screen driver to the new value.
  874.  
  875.         $  Sets the number of CRT columns.  A cls or reset command should be
  876.            given after changing the $ numeric parameter.  The default value
  877.            (80) is that returned by the BIOS video interrupt 15h call.  This
  878.            parameter may be set to support 132 column displays if the 132
  879.            column display mode is set before ZCOMM is called.[1] ZCOMM does
  880.            not support displays less than 80 columns wide.  The display
  881.            hardware must use the same number of columns as the $ parameter if
  882.            the resultant presentation is to make any sense.
  883.  
  884.            SEE ALSO: # numeric parameter
  885.  
  886.         -  If non zero, the system function (used with the ! command, etc.)
  887.            uses the undocumented DOS 37h function to fetch the current value
  888.            of SWITCHAR.
  889.  
  890.  
  891.         __________
  892.  
  893.          1. With most display BIOS ROMs, ZCOMM reads the columns and lines
  894.             values from the BIOS when starting up or regaining control after a
  895.             shell escape.
  896.  
  897.  
  898.  
  899.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  900.  
  901.  
  902.         Revised 09-05-87                        Universal Line Printer Edition
  903.         ZCOMM User Manual                                                  136
  904.  
  905.  
  906.            If negative, ZCOMM uses DOS line input (function 0xA) for commands
  907.            given from the main prompt.  This enables DOS command line editors
  908.            such as POLYboost [2] and CED.  When these editors are active, they
  909.            (and not ZCOMM) interpret control, function and ALT- keys.
  910.  
  911.         *  Sets the CRT attribute for highlighted messages.
  912.  
  913.            EXAMPLE: p*12 gives bright red.
  914.  
  915.  
  916.         ?  Count of the number of files sent or received with a protocol, and
  917.            the number of lines matched by the find command.  A failed password
  918.            validation sets this negative.  The exit status of subprograms is
  919.            stored in this parameter.  Because of a bug in DOS COMMAND.COM, the
  920.            return value is valid only with Unix/Xenix flavors.
  921.  
  922.            SEE ALSO: ?  test condition
  923.  
  924.         @  Sets the CRT attribute for the (normally) blinking messages such as
  925.            FILES OPEN.  The numeric values are explained below, with the n
  926.            numeric parameter.
  927.  
  928.            EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
  929.            bright red.
  930.  
  931.  
  932.         E  If non 0, substitute this for characters with bad parity detected
  933.            by the term function with e mode (Error Containment(TM)).
  934.  
  935.            EXAMPLE: iena -7e;  pE63 Substitute ?  for characters received with
  936.            odd parity.
  937.  
  938.  
  939.         H  Sets the timeout in seconds for entering a command or string in
  940.            response to a command or other prompt, including the accept
  941.            command.  A value of 0 (the default) disables this timeout.
  942.  
  943.         K  If non 0, executes keyboard BIOS calls to recover extended codes
  944.            from 101 key keyboards.
  945.  
  946.         N  If set to 32, reverses the relationship between Num-Lock and the
  947.            numeric/application keyboard mapping part of VT52/VT100 emulation
  948.            (when enabled with display kbmapenable).  When set to 0 (the
  949.            default) the numeric keypad operates as VT25/VT100 disagnostics
  950.            expect.
  951.  
  952.  
  953.         __________
  954.  
  955.          2. POLYboost is a product of the POLYTRON corporation.
  956.  
  957.  
  958.  
  959.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  960.  
  961.  
  962.         Revised 09-05-87                        Universal Line Printer Edition
  963.         ZCOMM User Manual                                                  137
  964.  
  965.  
  966.            SEE ALSO: display command, ALT-M command
  967.  
  968.         O  Controls OverThruster(TM) operation with B-Protocol, XMODEM,
  969.            XMODEM-1k, and YMODEM downloads.  This parameter should be set as
  970.            follows:
  971.  
  972.            Compuserve B Protocol Larger positive numbers up to 511 increase
  973.                 throughput.  Large numbers cause improperly interfaced MNP
  974.                 modems on CIS nodes to drop characters under stress.  To
  975.                 enable B protocol with OverThruster in term function:
  976.  
  977.                 EXAMPLE: pO200; t -oc
  978.  
  979.  
  980.            CompuServe XMODEM This OverThruster mode is effective only on
  981.                 CompuServe.  Negative numbers control the number of bytes
  982.                 added to the window on XMODEM downloads from the CompuServe
  983.                 Information Service.  Larger numbers increase throughput, but
  984.                 cause improperly interfaced MNP modems on CIS nodes to drop
  985.                 characters under stress, disrupting the file transfer.
  986.  
  987.                 EXAMPLE: pO-512; ro file1.ext
  988.  
  989.  
  990.            Other XMODEM Positive numbers up to a system dependent value less
  991.                 than the protocol block size increase throughput.  Larger
  992.                 values induce timeouts and/or retransmitted blocks.  The
  993.                 optimum value must be determined by experiment.  60 usually
  994.                 give best results with MNP modems at 2400 bps.
  995.  
  996.                 EXAMPLE: pO60; ro file1.ext
  997.  
  998.            This parameter is a no-op on Unix or small model flavors.
  999.  
  1000.         S  Timeout interval in seconds waiting for XON characters or positive
  1001.            flow control (default 15).  If an XON is not received within this
  1002.            time, transmission resumes anyway.  A value of 0 disables this
  1003.            timeout.
  1004.  
  1005.         V  VIDEO BIOS display mode to switch the display to 132 columns in
  1006.            response to a VT-100 DECCOLM mode set command.  A popular value is
  1007.            35 for the Tseng, ATI, and other extended EGA boards.  The default
  1008.            value of 0 inhibits this function.
  1009.  
  1010.         a  The a parameter calibrates certain protocol timeouts.  The default
  1011.            value is set during initialization to an appropriate value for an
  1012.            IBM Personal Computer, PC-jr, DG/One, or 8mHz PC-AT (2000 for 4.77
  1013.            mHz PC, 4000 for a PS2/30, 6000 for an 8 mHz AT, 12000 for a
  1014.            PS2/80).  If ZCOMM is run on a non standard machine, accelerator,
  1015.            or under a time slicing operating environment such as TopView,
  1016.            these timeouts may be recalibrated with the a numeric parameter.
  1017.  
  1018.  
  1019.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1020.  
  1021.  
  1022.         Revised 09-05-87                        Universal Line Printer Edition
  1023.         ZCOMM User Manual                                                  138
  1024.  
  1025.  
  1026.            Larger numbers give longer timeouts.  This parameter should then be
  1027.            set with a pa# command in the telephone directory setup entry.  The
  1028.            value for this parameter will change if ZCOMM is used with a
  1029.            different computer type or multitasking operating system.
  1030.  
  1031.         b  Sets the video color for the screen border.  The mapping of b
  1032.            parameter values to color is hardware dependent.  New values of the
  1033.            b parameter take effect with the next screen clear.
  1034.  
  1035.         c  The c parameter sets the callout interval in seconds between scans
  1036.            for outgoing messages.  The default is 300 seconds (five minutes).
  1037.  
  1038.            EXAMPLE: pc600 sets the interval betrween callout queue scane to 10
  1039.            minutes.
  1040.  
  1041.  
  1042.            SEE ALSO: Callout queue
  1043.  
  1044.         d  A non zero value (the default) causes incoming files received with
  1045.            ZMODEM and full YMODEM Batch protocol to have their Date set to
  1046.            that sent in the file header.  ZMODEM's file management features
  1047.            depend on the transmission of each file's modification date.  Files
  1048.            between two copies of ZCOMM will have the same creation date, even
  1049.            if the two machines are in different time zones.  When transferring
  1050.            files to/from a Unix system, creation dates are interpreted
  1051.            according to GMT or Universal Coordinated Time.  File dating should
  1052.            be enabled with a pd1 command in the telephone directory setup
  1053.            entry.
  1054.  
  1055.            SEE ALSO: z numeric parameter
  1056.            NOTE: Backdating file creation times may confuse some backup
  1057.            programs.
  1058.  
  1059.         e  Indicates the number of errors, failed file transfers and the
  1060.            number of characters received by the term function with parity
  1061.            error, framing error or overrun.
  1062.  
  1063.            EXAMPLE: if e>30 goto badline
  1064.  
  1065.  
  1066.            If the term function increments the error count to 0[3] (from a
  1067.            negative number), it exits, allowing the script to regain control
  1068.            in the event of a noisy line.  This condition would then be
  1069.            indicated by the e test condition being false (0).
  1070.  
  1071.  
  1072.  
  1073.         __________
  1074.  
  1075.          3. Refer to E mode decription for caveats.
  1076.  
  1077.  
  1078.  
  1079.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1080.  
  1081.  
  1082.         Revised 09-05-87                        Universal Line Printer Edition
  1083.         ZCOMM User Manual                                                  139
  1084.  
  1085.  
  1086.            EXAMPLE: pe-20; ... wait; if !e goto badline
  1087.  
  1088.  
  1089.            This parameter is reset to 0 by the call command.
  1090.  
  1091.            SEE ALSO: E mode
  1092.  
  1093.            SEE ALSO: e test condition (if, while commands)
  1094.  
  1095.         f  Fail time.  Sets the default timeout in seconds for matching a
  1096.            pattern.  This timeout is reset whenever a character is received
  1097.            from the remote.  Timeout is suspended whenever a XOFF (DC3 or
  1098.            Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q)
  1099.            is keyboarded.  This value may be overridden for one command by the
  1100.            ftime mode.
  1101.  
  1102.            EXAMPLE: pf15 sets a default 15 second inactivity timeout  for
  1103.            pattern searches.
  1104.  
  1105.  
  1106.         g  Set the "gochar" (decimal).  (See the ASCII/Decimal conversion
  1107.            table in Chapter 29).  The g parameter is reset to its default
  1108.            (linfeed, 10) by the call command.  (See documentation on the p
  1109.            mode.)
  1110.  
  1111.            Some remote systems accept uploads with a ? (decimal 63) prompt for
  1112.            each line.  Optimum operation with such a system might call for
  1113.  
  1114.                            pg63 pp1000 pt4 f -tp file1
  1115.  
  1116.            The pg63 sets the goahead character to question mark.  The pp1000
  1117.            sets the timeout to a long delay (10 seconds).  Te pt4 sets the
  1118.            upload throttle to 40 milliseconds per characters, a speed which
  1119.            allows the remote to echo somewhat slowly (assuming no tabs).
  1120.            Finally, the command f -tp file sends file1 with Throttle and wait
  1121.            for Prompt at end of line.
  1122.  
  1123.            As a special case, if the "gochar" is set to 17 (called XON, DC1,
  1124.            or ^Q) before the p mode is set, file transmission is stopped until
  1125.            an XON is keyboarded or received from the remote.
  1126.  
  1127.            EXAMPLE: pg17; ena -p
  1128.  
  1129.  
  1130.         h  Iff the h numeric parameter is set non zero, the h (Half Duplex)
  1131.            mode causes characters transmitted by the term function to be
  1132.            stored in the circular buffer as if they had been received from the
  1133.            remote.  This allows the review function to display them.  Since
  1134.            the echoed characters appear to have come from the remote, scripts
  1135.            may be affected, especially pattern searches.
  1136.  
  1137.  
  1138.  
  1139.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1140.  
  1141.  
  1142.         Revised 09-05-87                        Universal Line Printer Edition
  1143.         ZCOMM User Manual                                                  140
  1144.  
  1145.  
  1146.            EXAMPLE: ph1; ena -h
  1147.  
  1148.  
  1149.         i  Set the interval between retries to n seconds.
  1150.  
  1151.            EXAMPLE: pi4; call -200 busysys attack dials with 4 second
  1152.            intervals up to 201 times.
  1153.  
  1154.  
  1155.            SEE ALSO: call -n command
  1156.  
  1157.         j  Sets the maximum connect time in seconds allowed restricted callers
  1158.            in host operation.  The default value of 0 does not restrict
  1159.            connect time.
  1160.  
  1161.            EXAMPLE: pj300 disconnects restricted callers at the first command
  1162.            prompt after 5 minutes' connect time.
  1163.  
  1164.  
  1165.         k  When receiving data from the remote at high speeds (9600 or
  1166.            faster), the display may fall behind data from the remote.  Under
  1167.            these conditions, keyboarding an interrupt character (often Ctrl-C,
  1168.            or Break) will immediately stop the output from the remote, but the
  1169.            display will continue to scroll for some time while the data in the
  1170.            circular buffer is displayed.  If this is objectionable, the k
  1171.            parameter may be set to the remote's particular interrupt character
  1172.            (in decimal).  This parameter also affects the link command.  When
  1173.            this character is keyboarded, undisplayed data pending in the
  1174.            circular buffer is skipped over.  (This data is still available to
  1175.            the review command.  The call command resets this parameter to -1,
  1176.            disabling its function.
  1177.  
  1178.            EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs.
  1179.            Many Unix users also use ETX for interrupting programs.  The
  1180.            command pk3 causes ZCOMM to skip buffered output from the remote.
  1181.            Unix users using the default interrupt character of RUBOUT may give
  1182.            the command pk127
  1183.  
  1184.  
  1185.         l  Selects LPTn for term function output when the l mode is set.
  1186.            Default is 1 (LPT1).
  1187.  
  1188.            EXAMPLE: pl2 selects LPT2
  1189.  
  1190.         m  Causes file transmission with the f file command to pause when a
  1191.            character matching the decimal value is read from the file.  That
  1192.            character is NOT transmitted.  When the file uploading is paused, a
  1193.            keyboarded Ctrl-Q will resume transmission.  The call command
  1194.            resets the m parameter to -1 (which matches nothing).
  1195.  
  1196.            EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF).
  1197.  
  1198.  
  1199.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1200.  
  1201.  
  1202.         Revised 09-05-87                        Universal Line Printer Edition
  1203.         ZCOMM User Manual                                                  141
  1204.  
  1205.  
  1206.         n  Set the normal display attribute.  The default of 7 gives a normal
  1207.            white on black display.  The numbers associated with the s, r, and
  1208.            n are stored in the attribute byte of each character position
  1209.            written in the corresponding mode.
  1210.  
  1211.            The bit configuration (color display) is: Blink R G B  Intensity R
  1212.            G B with the leftmost the most significant.
  1213.  
  1214.            Users with color monitors often use 2 (green) to avoid color
  1215.            fringes caused by misconverged color monitors.
  1216.            NOTE: the actual writing color attribute is not changed until the
  1217.            next time the display is reset.  Some attributes generate
  1218.            unreadable displays.  Other attributes generate text that can only
  1219.            be seen on some monitors.
  1220.  
  1221.            EXAMPLE: pn3 sets cyan; pn2 sets green.
  1222.  
  1223.  
  1224.         o  Iff non zero, allows overlap of file writing and incoming data from
  1225.            the remote.  This increases throughput when receiving files with
  1226.            the B, XMODEM, and YMODEM Batch protocols, and allows streaming
  1227.            with ZMODEM.  ZCOMM sets this to 1 on startup unless a PC-jr is
  1228.            detected.
  1229.  
  1230.         p  Pause sets the echo wait period (in hundredths of seconds) used
  1231.            with the pattern command and the w and p modes.  Larger numbers
  1232.            give longer pauses.  The default works well with most micro based
  1233.            bulletin board systems.  The p parameter is reset to its default of
  1234.            70 (700 milliseconds approximately) by the call command.
  1235.  
  1236.            SEE ALSO: p mode
  1237.  
  1238.         q  Sets the "gopause".  When sending a file with a wait for "gochar" (
  1239.            p mode), ZCOMM waits Gopause hundredths of seconds AFTER it
  1240.            receives the "gochar".  The q parameter also controls the time
  1241.            delay after a normal pattern match or putw command.
  1242.  
  1243.            The q parameter is reset to its default of 70 (700 milliseconds
  1244.            approximately) by the call command.  The default value allows time
  1245.            for immediate echoes to be displayed and for the Hayes
  1246.            Smartmodem(TM) to respond to most commands.
  1247.  
  1248.            SEE ALSO: p mode
  1249.  
  1250.         r  Set the attribute for "reverse video".
  1251.  
  1252.            EXAMPLE: pr97 sets "reverse video" to blue on yellow.
  1253.  
  1254.  
  1255.            SEE ALSO: n numeric parameter
  1256.  
  1257.  
  1258.  
  1259.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1260.  
  1261.  
  1262.         Revised 09-05-87                        Universal Line Printer Edition
  1263.         ZCOMM User Manual                                                  142
  1264.  
  1265.  
  1266.         s  Set the attribute of the status line display (default 7, for
  1267.            white).  A value of 8 (grey) may be chosen to prevent the status
  1268.            line display from distracting from the information being printed.
  1269.            The low intensity grey also minimizes phosphor burn.  Some other
  1270.            possibilities are 2 for green, and 1 for blue (or underlined on the
  1271.            monochrome board).
  1272.  
  1273.            SEE ALSO: n numeric parameter
  1274.  
  1275.         t  Sets the throttle speed (delay between characters in hundredths of
  1276.            seconds) used by the term function when uploading files with an f
  1277.            -t file command.  The default value of 4 corresponds to about 20
  1278.            characters per second sending speed when t mode is enabled.  Larger
  1279.            numbers give slower transmission.  The effective resolution of the
  1280.            t parameter is limited by the timekeeping resolution of the
  1281.            operating system; on PC-DOS the resolution is about 18 per second.
  1282.  
  1283.            A negative value (-1 to -32767) may be used to specify a software
  1284.            timing loop, with more negative values giving slower transmission.
  1285.            The speed effect of a negative t value depends on the processor
  1286.            speed and operating environment.
  1287.  
  1288.            The t parameter is reset to its default by the call command.
  1289.  
  1290.            SEE ALSO: t mode
  1291.  
  1292.         u  Sets the video attribute used to represent underline.
  1293.  
  1294.            EXAMPLE: pu14 sets "underline" to yellow.
  1295.  
  1296.  
  1297.            SEE ALSO: n numeric parameter
  1298.  
  1299.         v  Sets the verbose level (default 0).  A value less than zero
  1300.            inhibits some routine messages.  A value greater then zero causes
  1301.            the set command to list all string parameters, including empty
  1302.            string parameters.  The screen erase after data calls in host
  1303.            operation is disabled.  Values greater than 1 display script
  1304.            commands as they are fetched from the script file.* Larger values
  1305.            give more detailed tracing information.  A value of 50+ causes data
  1306.            read by the read command to be displayed and acted upon by the term
  1307.            function (when called) as if it had arrived from the remote.
  1308.            NOTE: A v parameter value greater than zero affects scripts that
  1309.            generate files with the > command.
  1310.  
  1311.         w  Sets the maximum block length used by the Compuserve B Protocol
  1312.            when uploading files to Compuserve.  A longer length increases
  1313.            throughput, but may overload some networks, resulting in excessive
  1314.            retransmissions or failed uploads.  The maximum is 1024, the
  1315.            default is 512, as specified by Compuserve.  If B protocol uploads
  1316.            fail, try a smaller number.  The data contents of the uploaded
  1317.  
  1318.  
  1319.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1320.  
  1321.  
  1322.         Revised 09-05-87                        Universal Line Printer Edition
  1323.         ZCOMM User Manual                                                  143
  1324.  
  1325.  
  1326.            file(s) are not affected by this parameter.
  1327.  
  1328.            On downloads from Compuserve, ZCOMM accepts B protocol blocks of
  1329.            1024 bytes or less.
  1330.  
  1331.         x  Sets the port number linked with the link command.
  1332.  
  1333.            SEE ALSO: link command, y numeric parameter
  1334.  
  1335.         y  Sets the transmission speed used by the linked port.
  1336.  
  1337.            SEE ALSO: link command, x numeric parameter
  1338.  
  1339.         z  Set the timeZone in minutes behind GMT (Greenwich Mean Time).
  1340.  
  1341.            EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST.
  1342.  
  1343.  
  1344.            SEE ALSO: d numeric parameter
  1345.  
  1346.         _  The _ numeric parameter controls the action taken by ZCOMM when a
  1347.            fatal error (one that generates the "ZCOMM: Error..." message).
  1348.            Any non zero value causes DTR to be dropped (disconnect the modem).
  1349.            A value greater than 100 causes ZCOMM to exit to the operating
  1350.            system.  The NUKE key does not invoke this processing.
  1351.  
  1352.         22.1  Kermit Numeric Parameters
  1353.  
  1354.         The Super-Kermit parameters control Kermit protocol transfers.  They
  1355.         are set with the kermit px# command.  Their current values may be
  1356.         displayed with a kermit p command.  Most of these parameters rarely
  1357.         need changing.  These parameters can be changed in case of difficulty
  1358.         with Kermit transfers, especially with mainframe programs or obscure
  1359.         microcomputer Kermit impelementations.
  1360.  
  1361.         When transferring files with Kermit programs operating on IBM
  1362.         mainframes with half duplex front ends, the kermit i parameter should
  1363.         be set to 1, and the kermit s parameter set to the longest response
  1364.         time expected, perhaps 45 seconds.
  1365.  
  1366.         EXAMPLE: kermit pi1;  kermit ps45
  1367.  
  1368.  
  1369.         SEE ALSO: Kermit protocol in Chapter 12
  1370.  
  1371.         7 If non zero, force eighth bit quoting Kermit transmission even if
  1372.           ZCOMM is using eight bits no parity.  This parameter is reset by
  1373.           each call command.
  1374.  
  1375.         8 If non zero, force 8 bit transparent Kermit transmission even if
  1376.           ZCOMM is using seven bits.  Normally, ZCOMM uses 7 bit transmission
  1377.  
  1378.  
  1379.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1380.  
  1381.  
  1382.         Revised 09-05-87                        Universal Line Printer Edition
  1383.         ZCOMM User Manual                                                  144
  1384.  
  1385.  
  1386.           and 8th bit quoting if one of the 7 bits modes (7e, 7o, 7m, 7s) is
  1387.           used.  This parameter is reset by each call command.
  1388.  
  1389.         a Incoming packet-start character, default 1 (SOH).
  1390.  
  1391.         A Outgoing packet-start character, default 1 (SOH).
  1392.  
  1393.         b Block check type requested: 1=1 byte checksum, 2=2 byte checksum,
  1394.           3=3 byte CRC-16 (default).  Selecting a type 1 checksum instead of
  1395.           type 3 will increase throughput by 2-4 percent at the expense of
  1396.           weaker error checking.
  1397.  
  1398.         c Control prefix in incoming data, default 35 (pound sign).
  1399.  
  1400.         C Control prefix in outgoing data, default 35 (pound sign).
  1401.  
  1402.         d Delay in seconds before sending, default 0.
  1403.  
  1404.         e Incoming end of line character, default 13 (CR).
  1405.  
  1406.         E Outgoing end of line character, default 13 (CR).
  1407.  
  1408.         i Use IBM line turnaround, default 0 (don't).  The Kermit x numeric
  1409.           parameter sets the turnaround character.  This may be necessary when
  1410.           communicating with IBM mainframes with half duplex front ends.
  1411.  
  1412.         l Maximum outgoing packet length, default 94, max 94.
  1413.  
  1414.         L Maximum incoming packet length, default 94, max 94.
  1415.  
  1416.         r If non zero, remove incomplete received files except those received
  1417.           with the + option (default 0).
  1418.  
  1419.         s Timeout interval in seconds waiting for XON characters or positive
  1420.           flow control (default 15).  If an XON is not received within this
  1421.           time, transmission resumes anyway.  A value of 0 disables this
  1422.           timeout.
  1423.  
  1424.         t Override timeout interval in seconds for incoming packets.  The
  1425.           default of 0 allows the other program to specifiy the timeout.
  1426.  
  1427.         T Timeout interval for outgoing packets, default 4 seconds.
  1428.  
  1429.         w Sliding Window size in Kermit packets, 1 minimum, 31 maximum, 31
  1430.           default.  Setting w to zero disables the sliding window.
  1431.  
  1432.         x IBM turnaround character, default 17 (XON).
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1440.  
  1441.  
  1442.         Revised 09-05-87                        Universal Line Printer Edition
  1443.         ZCOMM User Manual                                                  145
  1444.  
  1445.  
  1446.         22.2  X/Y/ZMODEM Numeric Parameters
  1447.  
  1448.         These parameters control XMODEM, YMODEM, and ZMODEM protocol
  1449.         transfers.  They are set with the z px# command available with ZMODEM
  1450.         flavors of ZCOMM.  Their current values can be displayed with a z p
  1451.         command.  These parameters rarely need changing in normal
  1452.         environments.
  1453.  
  1454.         b If non zero, ZMODEM sends a break when it is sending a file and
  1455.           receives a retransmission request.  This mode of operation may be
  1456.           used with high speed modems to clear unwanted characters from the
  1457.           modem's buffer during error recovery.  Usually, the modem must be
  1458.           given a configuration command to set the proper action to take when
  1459.           receiving a break signal.
  1460.  
  1461.         B Sets the duration of the break signal in tenths of a second, default
  1462.           2 (200 milliseconds).
  1463.  
  1464.         C Sets the number of times ZMODEM will attempt to send a command (as a
  1465.           result of a zcommand command) (default 11).
  1466.  
  1467.         e If non zero, escape all control characters.  This allows ZMODEM
  1468.           transfers to operate over data PBX and other systems that freak out
  1469.           when they receive control characters.
  1470.  
  1471.         l If non zero, forces ZMODEM to wait for an ACK after each # bytes
  1472.           (default 0).  This may be adjusted to prevent buffer overflow in
  1473.           data PBX systems.
  1474.  
  1475.         L (Default 0) If non zero, overrides the nominal length of data
  1476.           subpackets within each ZMODEM frame.  A smaller value speeds error
  1477.           recovery on noisy lines, a large value (maximum 1024) reduces the
  1478.           overhead of CRC characters.
  1479.  
  1480.         n Sets the number of NULLS (default 0) sent before each ZDATA frame.
  1481.           Some buffered modems (Fastlink) have a firmware bug which loses
  1482.           characters when changing the direction of transmission.  This causes
  1483.           data frames to fail with a reported CRC error.  ZMODEM n parameter
  1484.           values in the range of 100 to 150 have obviated this syndrome.
  1485.  
  1486.         r If non zero, remove incomplete received files except those received
  1487.           with the + option (default 0).
  1488.  
  1489.         w If non 0, restrict the ZMODEM transmitted window to the specified
  1490.           number of bytes.  Setting this parameter to N requests
  1491.           acknowledgements from the receiver every N/4 characters.  ZCOMM then
  1492.           waits for acknowledgements from the receiver whenever it has sent N
  1493.           more characters than it has received acknowledgements for.  This
  1494.           parameter is useful with networks with defective flow control, and
  1495.           with networks that store an excessive number of characters in
  1496.           transit.  The call command resets this parameter to 0.
  1497.  
  1498.  
  1499.         (C) 1987 Omen Tech Inc                   Chapter 22 Numeric Parameters
  1500.  
  1501.  
  1502.         Revised 09-05-87                        Universal Line Printer Edition
  1503.         ZCOMM User Manual                                                  146
  1504.  
  1505.  
  1506.         W Adjusts the number of characters the ZMODEM receiver will silently
  1507.           ignore when searching for the beginning of a new frame.  This may be
  1508.           set larger to accomodate networks with excessive in transit storage,
  1509.           smaller to speed error recovery from long error bursts on direct
  1510.           connections.
  1511.  
  1512.         Z Number of minutes (default 0) to adjust the file modification date
  1513.           when using the Telink or Clink/SEAlink file transfer protocol to
  1514.           transfer a file between different time zones.
  1515.  
  1516.         The timeout parameters below may be set lower for faster X/YMODEM
  1517.         error recovery when transferring files between two micros, higher to
  1518.         accomodate extremely sluggish systems.  Only in pathological cases is
  1519.         it necessary to modify these parameters.
  1520.  
  1521.         p Timeout in tenths of seconds for gaps within a packet (default 50).
  1522.  
  1523.         s Timeout interval in seconds waiting for XON characters or positive
  1524.           flow control (default 15).  If an XON is not received within this
  1525.           time, transmission resumes anyway.  A value of 0 disables this
  1526.           timeout.
  1527.  
  1528.         t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
  1529.           waiting for a packet or command acknowledgement (default 100).
  1530.  
  1531.         T Transmitter timeout in tenths of seconds waiting for a packet
  1532.           (default 600).
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.         (C) 1987 Omen Tech Inc                    Chapter 22 String Parameters
  1560.  
  1561.  
  1562.         Revised 09-05-87                        Universal Line Printer Edition
  1563.         ZCOMM User Manual                                                  147
  1564.  
  1565.  
  1566.         23.  STRING PARAMETERS
  1567.  
  1568.  
  1569.         The set command without arguments displays the current values and
  1570.         maximum string length for each of the non-empty string parameters.  To
  1571.         set a parameter empty, enter "" as the parameter string (e.g., set
  1572.         txlog "").  Certain string parameters may be entered with ZCOMM's
  1573.         character escapes.
  1574.  
  1575.         When a string parameter is executed, it may be either sent to the
  1576.         remote as a string or executed as a command if its first character is
  1577.         @.
  1578.  
  1579.         EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote.
  1580.  
  1581.  
  1582.         EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the
  1583.         screen.
  1584.  
  1585.  
  1586.         In strings sent to the remote, a \336 (octal 336) character causes a
  1587.         pause in transmission[1] (controlled by the p numeric parameter),
  1588.         which may be used to send multiple commands with one string.
  1589.  
  1590.         An optional underscore prepended to the name of a permament string
  1591.         parameter causes that string parameter to be cleared by the next call
  1592.         command.
  1593.  
  1594.         The following string parameters may be accessed but not modified by
  1595.         the set command or in string expansions when ZCOMM is Restricted:
  1596.             backtab bbs break bs esc etx exrc f1...f40 fdel fdown fhome fins
  1597.             fleft fpgdn fpgup fright fup l m outahost password quitcmd rub tab
  1598.             unrestrict
  1599.  
  1600.         The following may not be modified by the set command when ZCOMM is
  1601.         restricted:
  1602.             answerback baudstr blankfill call2 callers* challenge disks e
  1603.             emdir entstr eolstr helpfile home lib lpnono mcommand mconnect
  1604.             menu messages mprefix msuffix phones picture plog private remote
  1605.             telno tmp twxfile welcome xhelpfile
  1606.  
  1607.         The following parameters can never be modified by the set command: ano
  1608.             args c d e h oname1...oname5 s t w y y0...y127 yb yf
  1609.  
  1610.         String Parameters for Remote Operation:
  1611.  
  1612.  
  1613.         __________
  1614.  
  1615.          1. Not including the mput command
  1616.  
  1617.  
  1618.  
  1619.         (C) 1987 Omen Tech Inc                    Chapter 23 String Parameters
  1620.  
  1621.  
  1622.         Revised 09-05-87                        Universal Line Printer Edition
  1623.         ZCOMM User Manual                                                  148
  1624.  
  1625.  
  1626.             answerback baudstr bbs call2 callers challenge disks emdir exrc
  1627.             helpfile home menu messages outahost password private pwd twxfile
  1628.             unrestrict welcome xhelpfile
  1629.         String Parameters for Non Protocol File Transfer:
  1630.             blankfill eolstr
  1631.         String Parameters for Interactive Operation:
  1632.             backtab break bs entstr esc etx lpnono Soft Keys tab rub
  1633.         String Parameters for Scripts:
  1634.             ano args c d e h item lib oname1...oname5 remote rxcnt s s0...s9 t
  1635.             tmp y y0...y127 yb yf
  1636.         String Parameters for Making Calls:
  1637.             l m mcommand mconnect mprefix msuffix telno
  1638.         String Parameters for Log Keeping:
  1639.  
  1640.             callers* calllog* plog rcmdlog* rxlog* txlog*
  1641.         Other String Parameters:
  1642.             helpfile home kermreset menu picture phones quitcmd
  1643.  
  1644.  
  1645.         ano After invoking one of the date related string parameters, the ano
  1646.             string contains the last two digits of the year.
  1647.  
  1648.         answerback When term is in q (TWX) mode, an answerback is sent in
  1649.             response to an incoming ENQ.  The format of Answerback is
  1650.             determined by the Western Union Telegraph Company.  It typically
  1651.             consists of
  1652.                                   \r\nNAME CITY\r\n\021
  1653.             as entered by the set command using character escapes.  (In the
  1654.             TWX protocol, the 021 (XON) at the end of the answerback turns on
  1655.             the tape reader.) The answerback string must begin with CR,LF.
  1656.  
  1657.         args contains the complete calling sequence to the current script
  1658.             level.
  1659.  
  1660.             EXAMPLE: call ge,upl accesses the genie telephone directory entry
  1661.             and stores ge.upl in args.
  1662.  
  1663.  
  1664.         backtab Assigns a string or command to the BACKTAB (Shift TAB) key.
  1665.  
  1666.         baudstr When ZCOMM gets a connect in host operation, ZCOMM executes
  1667.             baudstr.
  1668.  
  1669.             EXAMPLE: set baudstr "@gosub .%lib/baud.t"
  1670.  
  1671.  
  1672.         bbs May contain a shell escape command to activate a Bulletin Board
  1673.             program.  The bbs string parameter is always processed as a shell
  1674.             escape command, and should not include a leading "!".
  1675.  
  1676.             EXAMPLE: set bbs "~bbsprog"
  1677.  
  1678.  
  1679.         (C) 1987 Omen Tech Inc                    Chapter 23 String Parameters
  1680.  
  1681.  
  1682.         Revised 09-05-87                        Universal Line Printer Edition
  1683.         ZCOMM User Manual                                                  149
  1684.  
  1685.  
  1686.         blankfill When transmitting a file with the term function with p, r,
  1687.             or w modes, ZCOMM sends the contents of blankfill (if set) to
  1688.             prevent the remote from receiving a blank (empty) line.  (Some
  1689.             programs interpret a blank line as an exit from text entry.) ZCOMM
  1690.             Character Escapes must be used to represent control characters.
  1691.             If blankfill is empty, nothing is sent. The call command resets
  1692.             blankfill to empty.
  1693.  
  1694.         break Stores a string or command to be executed by the Ctrl-Break key
  1695.             instead of the default 100 ms break.
  1696.  
  1697.             EXAMPLE: Some Novation modems cannot pass a break signal:
  1698.  
  1699.               set break "@break putw %B\336\ 1\r putw %U\336\ 0\r"
  1700.  
  1701.             Causes the break key to send a break to get the modem's attention,
  1702.             then tells the modem to send the break itself, and finally
  1703.             restores
  1704.  
  1705.             the modem's ersatz "transparent" mode.
  1706.  
  1707.             SEE ALSO: break command
  1708.  
  1709.         bs  Stores an alternate string or command to be executed by the
  1710.             backspace key when in the term function.
  1711.  
  1712.         c   When the h or s string parameters is accessed, the hundredths of a
  1713.             second are stored in the c string parameter.  The accuracy and
  1714.             precision of this quantity depend on the operating environment.
  1715.  
  1716.         call2 Sets the string be sent to the modem or command to be executed
  1717.             each time ZCOMM begins to wait for a call in Host State.
  1718.             Typically this would command the modem to enable autoanswer for
  1719.             incoming calls.
  1720.  
  1721.             EXAMPLE: set call2 "ATMS0=1\r" (Hayes Modem)
  1722.  
  1723.  
  1724.         callers A pathname in which a log of successful host state logins is
  1725.             kept.  If callers is null (the default), no log is kept.
  1726.  
  1727.         challenge is executed when the caller connects and handshakes to
  1728.             determine transmission speed.
  1729.  
  1730.             EXAMPLE: set challenge "@gosub .%lib/challeng.t"
  1731.  
  1732.  
  1733.         d   Is set to the date when called, in the form "mmdd".
  1734.  
  1735.             EXAMPLE: t cia%d.TXT If the date is December 7, ZCOMM enters the
  1736.             term function with capture to KGB1207.txt
  1737.  
  1738.  
  1739.         (C) 1987 Omen Tech Inc                    Chapter 23 String Parameters
  1740.  
  1741.  
  1742.         Revised 09-05-87                        Universal Line Printer Edition
  1743.         ZCOMM User Manual                                                  150
  1744.  
  1745.  
  1746.             EXAMPLE: create -st+ cbbs%d.tmp
  1747.  
  1748.  
  1749.             SEE ALSO: h, t string parameters
  1750.  
  1751.         disks Contains the disks that may be logged into with with the d:
  1752.             command where "d" is the drive letter, or that may appear as part
  1753.             of a pathname.  If empty (the default), drive letters are not
  1754.             checked.  This parameter should be set to prevent local or remote
  1755.             users from hanging the system by accessing an off-line disk drive.
  1756.             It is also be used to prevent restricted remote users from
  1757.             accessing private data files.  This string must be entered in
  1758.             lower case.
  1759.  
  1760.             EXAMPLE: set disks "abc"
  1761.  
  1762.  
  1763.             SEE ALSO: home string parameter
  1764.  
  1765.         emdir A directory pathname for incoming electronic mail files.  emdir
  1766.             affects twxfile unless twxfile is an absolute path.  emdir is also
  1767.             used for incoming electronic mail using the YMODEM Batch protocol
  1768.             in the absence of a login.
  1769.  
  1770.             EXAMPLE: set emdir "/memo"
  1771.  
  1772.  
  1773.         entstr If entstr is set, ZCOMM sends the contents of entstr when ENTER
  1774.             (carriage return key) is keyboarded in the term function, unless n
  1775.             mode is in effect.  ZCOMM Character Escapes must be used to
  1776.             represent control characters.  If entstr is empty, a carriage
  1777.             return is sent.  The "call" command resets entstr to empty.
  1778.  
  1779.             EXAMPLE: set entstr "\3"
  1780.  
  1781.             sends an ETX (octal 3) when Enter is keyboarded.  This is handy
  1782.             for some computer systems that expect keyboarded lines to be
  1783.             terminated with something other than the usual carriage return.
  1784.             NOTE: The characters in entstr are always sent at full speed.
  1785.  
  1786.             SEE ALSO: eolstr string parameter
  1787.  
  1788.         eolstr When transmitting a file with the term function with p, r, or w
  1789.             modes, ZCOMM sends the contents of eolstr (if set) to terminate
  1790.             the line.  ZCOMM Character Escapes must be used to represent
  1791.             control characters.  If eolstr is empty, a carriage return is
  1792.             sent. The "call" command resets eolstr to empty.
  1793.  
  1794.             EXAMPLE: set eolstr "\r."
  1795.  
  1796.             sends a carriage return followed by a period at the end of each
  1797.  
  1798.  
  1799.         (C) 1987 Omen Tech Inc                    Chapter 23 String Parameters
  1800.  
  1801.